NAME¶

xcb_list_fonts_with_info - get matching font names and information

SYNOPSIS¶

#include <xcb/xproto.h>

typedef struct xcb_list_fonts_with_info_reply_t {


    uint8_t        response_type;


    uint8_t        name_len;


    uint16_t       sequence;


    uint32_t       length;


    xcb_charinfo_t min_bounds;


    uint8_t        pad0[4];


    xcb_charinfo_t max_bounds;


    uint8_t        pad1[4];


    uint16_t       min_char_or_byte2;


    uint16_t       max_char_or_byte2;


    uint16_t       default_char;


    uint16_t       properties_len;


    uint8_t        draw_direction;


    uint8_t        min_byte1;


    uint8_t        max_byte1;


    uint8_t        all_chars_exist;


    int16_t        font_ascent;


    int16_t        font_descent;


    uint32_t       replies_hint;
} xcb_list_fonts_with_info_reply_t;

REQUEST ARGUMENTS¶

conn

The XCB connection to X11.

max_names

The maximum number of fonts to be returned.

pattern_len

The length (in bytes) of pattern.

pattern

A font pattern, for example "-misc-fixed-*".

The asterisk (*) is a wildcard for any number of characters. The question mark (?) is a wildcard for a single character. Use of uppercase or lowercase does not matter.

REPLY FIELDS¶

response_type

The type of this reply, in this case XCB_LIST_FONTS_WITH_INFO. This field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other.

sequence

The sequence number of the last request processed by the X11 server.

length

The length of the reply, in words (a word is 4 bytes).

name_len

The number of matched font names.

min_bounds

minimum bounds over all existing char

max_bounds

maximum bounds over all existing char

min_char_or_byte2

first character

max_char_or_byte2

last character

default_char

char to print for undefined character

properties_len

how many properties there are

draw_direction

One of the following values:

min_byte1

TODO: NOT YET DOCUMENTED.

max_byte1

TODO: NOT YET DOCUMENTED.

all_chars_exist

flag if all characters have nonzero size

font_ascent

baseline to top edge of raster

font_descent

baseline to bottom edge of raster

replies_hint

An indication of how many more fonts will be returned. This is only a hint and may be larger or smaller than the number of fonts actually returned. A zero value does not guarantee that no more fonts will be returned.

DESCRIPTION¶

Gets a list of available font names which match the given pattern.

RETURN VALUE¶

Returns an xcb_list_fonts_with_info_cookie_t. Errors have to be handled when calling the reply function xcb_list_fonts_with_info_reply.

If you want to handle errors in the event loop instead, use xcb_list_fonts_with_info_unchecked. See xcb-requests(3) for details.

ERRORS¶

This request does never generate any errors.

SEE ALSO¶

xcb-requests(3)

AUTHOR¶

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.